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ABSTRACT 



A system and method for transfernng a file from a client 
platform to a server platform. A procedure_to_invoke 
parameter is set equal to information identifying a file 
transfer procedure located at the s^er platform. A pointer 
in a first "sqlvar" parameter is caused to point to the string 
representing the file, and a pointer in a second sqlvar 
parameter is caused to point to a file name of the file. The 
first and second sqlvar parameters are part of an input_args 
parameter. A "sqleproc** function is invoked at the client 
platform. The proccdure_to_invokc and input_args 
parameters are passed to the sqleproc function. The sqleproc 
function when executed causes the input_arg5 parameter to 
be passed to the file transfer procedure at the server 
platform, and also causes the file transfer procedure to be 
invoked at the server platfomt 

39 Claims, 6 Drawhig Sheets 
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PLATFORM-TRANSPARENT 
REGISTRATION AND BUILD OF STORED 
PROCEDURES AND USER-DEFINED 
FUNCTIONS 

CROSS-REFERENCE TO OTHER 
APPUCAnONS 

The following applications of common assignee contain 
some common disclosure, and are believed to have an 
effective filing date identical with that of the present appli- 
cation. 

"SYSTEM AND METHOD FOR ENABLING A COM- 
PILED COMPUTER PROGRAM TO INVOKE AN 
INTERPREnVE COMPUTER PROGRAM," application 
Ser. No. 08/521,805, filed Aug, 31, 1995, incoiporated 
herein by reference in its entirety. 

"PASSING STRUCTURES OR ARRAYS AS HOST 
VARIABLES " appUcation Ser. No. 08/521,710, filed Aug. 
31, 1995, incoiporated herein by reference in its entirety. 

"SYSTEM AND METHOD FOR ENABLING POINT- 
ERS TO BE PASSED FROM COMPUTER PROGRAMS 
WRTFTEN USING COMPUTER PROGRAMMING LAN- 
GUAGES THAT DO NOT SUPPORT POINTERS," appH- 
cation Ser. No. 08/521,806, filed Aug. 31, 1995, incoqx)- 
rated herein by reference in its entirety. 

"NO PREPROCESSOR AND A SOURCE LEVEL 
DEBUGGER FOR EMBEDDED SQL IN A 3GL appli- 
cation Ser. No. 08/521,711, filed Aug. 31, 1995, incapo- 
rated herein by reference in its entirety. 

TECHNICAL FIELD 

The present invention relates generally to stored proce- 
dures and user-defined functions in database systems, and 
more particularly to a system and method for registering and 
building stored procedures and user-defined functions in 
database systems. 

BACKGROUND ART 

Stored procedures and user-deilned functions are conven- 
tionally employed to augment the functional capabilities of 
database systems, lypically, stored procedures and user- 
defined functions are developed by progranmiers at database 
server platfOTms (ic., computers). After they have been fully 
developed, they are stored in the database server platforms. 
The stored procedures and user-defined functions may then 
be invoked by database clients. 

The development of procedures and user-defined fiinc- 
tions at database server platforms potentially increases the 
worldoad at these platforms. Thus, it is often disadvanta- 
geous to develop stored procedures and user-deiined func- 
tions at the database server platforms since such develop- 
ment may degrade system performance. This problem is 
exacerbated if many programmers are working at the data- 
base server platforms at the same time. Also, it is not always 
possible to develop stored procedures and user-defined 
functions at the database server computers, particularly 
when the same application must be deployed to multiple 
database servers. 

One solution to this problem is to have the programmers 
develop the stored procedures and user-defined functions at 
database client platforms. This potentially decreases the 
workload at database server platforms, thereby improving 
system performance. According to this approach, however, 
IH-ogrammers must manually distribute, build, and register 
the completed stored procedures and user-defined functions 
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at the database server platforms. This can be a very difficult 
task, especially if there are many database server platforms 
(in some systems, there are hundreds or even thousands of 
database server platforms). 

5 Also, distributing, building, and registering stored proce- 
dures and user-defined functions are very low-level tasks. To 
perform such tasks, the progranmiers must know the physi- 
cal addresses of the database server platforms (typically, 
programmers only know the aliases of die database server 

10 platforms, where such aliases are abstract, user-fticndly 
representations of the physical addresses), and the process 
for invoking the build and registration utilities (this may 
vary from platform to platform). Accordingly, this conven- 
tional solution is not ideal. 

15 

DISCLOSURE OF INVENTION 

Briefly stated, the present invention is directed to a system 
and method for transferring a file from a client platform to 
a server platfona The server platform is coupled to the 

20 client platform. A "DB2" relational database management 
system (RDBMS) executes on the server platform. 

According to the present invention, the file to be trans- 
ferred is converted to a string at the client platform. A 
procedure__to_Jnvoke parameter is set equal to information 
identifying a file transfer procedure located at the server 
platform. A pointer in a first "sqlvar" parameter is caused to 
point to the string, and a pointer in a second sqlvar parameter 
is caused to point to a file name of the file. The first and 
second sqlvar parameters are part of an input_args 

^ parameter, where the input_args parameter is of a "sqlda" 
data type. The sqlda data type is suitable for passing scalar 
values to procedures. 

A "sqleproc" function is invoked at the client platform. 
The sqleproc function is provided by a "client application 
enablement** (CAE) module that is resident in tiie client 
platform and that represents a client component of the DB2 
RDBMS. A parameter list of the sqleproc function includes 
the input_args parameter and the procedure_to_Jnvoke 

^ parameter. The sqleproc function when executed causes the 
input_args parameter to be passed to the file transfer pro- 
cedure at the server platform, and also causes the file transfer 
procedure to be invoked at the server platform. 
The file transfer procedure at the server platform receives 

45 the input_args parameter. The file transfer procedure uses 
the pointer in the first sqlvar parameter of the input_args 
parameter to access and retrieve the string. The string is 
converted to a new file. The file transfer procedure uses the 
pointer in the second sqlvar parameter of the input_aigs 

5Q parameter to access and retrieve the file name. The file 
transfer procedure stores the new file in the server platform 
using the file name. 

Further features and advantages of the invention, as well 
as the structure and operation of various embodiments of the 

55 invention, are described in detail below with reference to the 
accompanying drawings. In the drawings, like reference 
numbers generally indicate identical, functionally similar, 
and/or structurally similar elements. The drawing in which 
an element first appears is indicated by the digit(s) to the left 

60 of the two rightmost digits in the corresponding reference 
numbCT. 

BRIEF DESCRIPTION OF FIGURES 

The present invention will be described with reference to 
65 the accompanying drawings, wherein: 

FIG. 1 is a block diagram of a database system according 
to a preferred embodiment of the invention; 
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FIG. 2 is a block diagram of a preferred conq)uter useful 
for implementing components of the database system of 
HG. 1; 

FIGS. 3-5 and 7 are flowcharts depicting the preferred 
operation of the invention; and 

FIG. 6 is used to describe sqlvars in an sqlda data structure 
type. 

BEST MODE FOR CARRYING OUT THE 
INfVENTION 

The present invention is directed to a system and method 
for enabling users at client platforms (a "client platform" is 
a con^uter that has been set up to access database servers as 
a ciient) to distribute their stored procedures and/or user- 
defined functions from the dient platforms to server plat- 
forms (also called servers). The present invention also 
enables the users at the client platforms to make and register 
their stored procedures and/or user-defined functions at the 
servers. The invention provides this functionality in an 
user-friendly maimer. In particular, the invention does not 
require that users have knowledge of low-level details (such 
as the physical paths to server platforms) in order to 
distribute, make, and register &eir stored procedures and/or 
user-defined functions. 

FIG. 1 is a block diagram of a database system 102 
according to a preferred embodiment of the present inven- 
tion. The database system 102 includes a plurality of client 
platforms, sudi as client platform 104, and a plurality of 
server platforms (also called servers), such as servers 11$, 
120, 122, connected to each other via a network 116. 

The servers 118, 120, 122 eadi re|a*esent a relational 
database management system (RDBMS). Preferably, the 
RDBMS at each server 118, 120, 122 is DB2 available from 
International Business Machines (IBM Corporation). 
Specifically, the RDBMS is DB2 for Workstations (such as 
DB2 for AIX/6000, DB2 for OS/2, etc.). More particularly, 
the HDBMS is DB2 for Workstations Version 2.1 or greater. 
Pertinent aspects of DB2 are described in many publicly 
available documents, such as DATABASE 2 OS/2 Program- 
ming 

Reference, Order Number S62G-3666-00, March 1993, 
DATABASE 2 AIX/6000 Programming Reference, Order 
Number SC09-157300, 1993, and IBM Operating Systera/2 
Extended Edition Database Manager Programming Guide 
and Reference, 90X7905, 1993, which are incorporated 
herein by reference in their entireties. 

Each server 118, 120,122 includes a software library, such 
as a dynamic link library (DLL) 124, containing software 
procedures that may be invoked by clients 106. For purposes 
of the present invention, the DLL 124 includes a file transfer 
procedure 126, a make procedure 128, and a registration 
procedure 130, although in practice the DLL 124 may 
contain other software procedures. The file transfer proce- 
dure 126, the make procedure 128, and the registration 
Iffocedure 130 are described below. 

The client platform 104 includes one or more clients, such 
as client 106. The dient 106 accesses the data and proce- 
dures at the servers 118, 120, 122. According to the present 
invention, the client 106 may also develop stored procedures 
and/or user-defined functions at the client platform 104. and 
distribute, make, and register such stored procedures and/or 
user-defined functions to one or more of the servers 118, 
120, 122. This is described in greater detail below. 

The client platform 104 also includes a client application 
enablement (CAE) module 114. The CAE 114 is a compo- 
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nent of the DB2 RDBMS executing in each dient platform 
104. The CAE 114 enables the ciient 106 to interact with the 
DB2 RDBMS at each server 118, 120, 122. According, the 
CAE 114 represents the client component of DB2. 
5 The CAE 114 is consistent with the well known DARI 
(Database AK>Ucation Remote Interface) application pro- 
gramming interface (API). The DARI API specifies a user 
interface for remotely accessing database functions. The 
DARI API does not require that users have knowledge of 
low-levd details in order to access sudi database functions. 
For example, according to the DARI API, users need only 
know the alias of a server fdatform in orda to interact with 
the resident server. Users need not know the actual, physical 
address of the server platfomL 

Since it is consistent with the DARI API, the CIAE 114 
enables users to interact with the DB2 RDBMS at each 
servCT 118, 120, 122 in an user-ftiendly manner. However, 
the functionality of the CAE 114 is limited. For example, ttie 
CAE 114 does not provide any facilities for enabling the 

^ transfer of files between a client platform and a server 
platform. Pertinent aspects of the CAE 114 are described in 
many publicly available documents, sudi as DATABASE 2 
OS/2 Programmin Reference, Ordo* Number S62G-3666- 
00, March 1993, DATABASE 2 AIX/6000 Programming 

^ Reference, Order Number SC09-1573-00, 1993, and IBM 
Operating System/2 Extended Edition Database Manager 
Programming Guide and Reference, 90X7905, 1993, which 
are incorporated herein by reference in their entireties. 

2p As noted above, the present invention enables users at 
client platforms 104 to distribute their stored procedures 
and/or user-defined functions firom the client platforms 104 
to the servers 118, 120, 122. The present invention also 
enables the users at the client platforms 104 to make and 

22 register their stored procedures and/or user-defined func- 
tions at the servers 118, 120, 122. The invention provides 
this functionality in an user-ftiendly maimer. In particular, 
the invention does not require that users have knowledge of 
low-level details (such as the physical paths to server 

^ platforms) in order to distribute, make, and register their 
stored procedures and/or user-defined functions. 

Generally, the invention achieves its **user-friendliness" 
by employing the CAE 114 to interact with the DB2 
RDBMS at each server 118, 120, 122. As noted above, 

45 however, the functionality of the CAE 114 is limited. There 
are some functions not provided by the CAE 114 that the 
invention requires. The invention overcomes these limita- 
tions of the CAE 114 by, in effect, extending the functional 
capability set of the CAE 114. 

50 For example, a file transfer capability is necessary in order 
to distribute stored procedures and/or user-defined functions 
ftom the client platfonns 104 to the servers 118, 120, 122. 
The CAE 114, however, does not provide any facilities for 
enabling the transfer of files between a dient platform 104 

55 and a server platform 118, 120, 122. 

Conventionally, file transfer between the client platform 
104 and the server {datforms 118, 120. 122 is adiieved by 
using a mechanism that does not involve the CAE 114, such 
as the well known FTP (file transfer protocol). To use FTP, 

60 users must have knowledge of low-level details, such as the 
physical addresses of servers, and wh^er to transfer as 
ASCII or binary. They must also separately log on to the 
server, and navigate to an appropriate location in the direc- 
tory structure on the server. Navigation requires knowledge 

63 of appropriate operating-system-specific directory com- 
mands. FTP may require additional installation for OS/2 and 
Windows users. Accordingly, the use of FTP is not uscr- 
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friendly. In contrast, the invention extends the functional March 1993, DATABASE 2 AIX/6000 Programming 

capability set of the CAE 114 to enable the CAE 114 to Reference, Order Number SC(y9-157300, 1993, and IBM 

transfer files, and then uses the CAE 114 to transfer files Operating System/2 Extended Edition Database Manager 

between the dicnt platfoim 104 and the servers 118, 120, Programming Guide and Reference, 90X7905, 1993, which 
122. Since it uses the CAE 114 to perform this function, the 5 are incorporated herein by reference in their entireties. The 

transfer of files is performed in an user-friendly manner. documented purpose of the sqleproc function, as stated in all 

TTTi^ r * A * sudi documents known to the Inventors, is to enable a client 

FIG. 2 IS a block cUagram of a computer 202 us^ to ^^^^^ ^^^^^ ^ ^^^^ ^^^^ ^ 

implement elements of the mvenUon m cUent pktfom example, the dient 106 ^ould utilize the sqleproc function to 

104 and the server platforms 118, 120, 122 may be unple- j^voke at the server 122 the file tiansfff procedure 126, the 

mented using computers such as the con^xiter 202 m FIG. lo ^^^^ procedure 128, and/or the registration procedure 150. 

^- Once invoked, these procedures 126, 128, 130 would 

The computer 202 includes one or more process<ffs, such execute at the sender 122. 

as processor 204. The processor 204 is connected to a The syntax of the sqleproc function is as follows: 
communication bus 206. 

The computer 202 also indudes a main memory 208, — — — — — ^ 

preferably random access memory (RAM), and a secondary ietunu/«fc (pTocedur€_to_mvokc, 

memory 210. The secondary memory 210 includes, for sqicpnx 

example, one or more hard disk drives 212 and/or one or infb_fiekJ, 

more removable storage drives 214, each representing a ^ ^St^^ 

floppy disk drive, a magnetic tape drive, a compact disk cooununicatioa^aiea) 
drive, etc. These devices may be connected directly to the 
bus 206 or may be connected over a network (not shown). 

The removable storage drives 214 each reads from and/or f"^ evident from the above, the parameter list of the 

writes to a removable storage unit 216 in a weU known I'i^'f?^ ^^"'^^^ procedure_to_invoke, info_ 

jjj^^ 25 field, mput_args, oulput_args, and commumcation_area. 

_ ' , ^ ..-^^1 ,1 J . The procedure_to_Jnvoke parameter is a string that 

Removable storage umt 216, also caU«i a program stor- specified the procedure that the dient wants to invoke, 

^e device or a computer prograni product, represents a For AIX/6000 servers, this string must include the path to 

floppy disk, magnetic tape, compact disk, etc. As wiU be the procedure relative to the rclcvSit server; however, OS/2 

^preaated, the removable storage umt 216 includes a 30 servers can find the procedure if its path is included in the 

computer usable storage medium having stored therein UBPATH. For exan^>le, suppose that the dient 106 wanted 

con^uter software and/or data. ^ invoke the make procedure 128 at serva 122. In this case. 

Computer programs (also called computer control logic) the procedure_jo_Jnvoke parameter for AIX/6000 would 

are stored in main memory 208 and/or the secondary be of the form: 

memory 210. Sudi computer programs, when executed, 35 •*path\DLL!<entry point into DLL^" 

enable the computer 202 to perform the features of the por OS/2: 

present invention as discussed herein. In particular, the "DLL!<entry point into DLL>" 

computer programs, when executed, enable the process^ «*path" specifies the path to the DIX 124 relative to 

204 to perform the features of the present invention. server 122, "DLL" refers to the DLL 124, and "<entry 

Accordingly, such computer programs rep-esent controllers 40 j^i^j ^j^^ DLL>" represents infcnnation that identifies the 

of the computer 202. The cUent 106, the CAE 104, and the ^j^^ poi^t i^^to the DLL 124 cciresponding to the make 

DB2 RDBMS at the servers 118, 120,122 represent com- procedure 128. 

puter programs executing in their respective computers 202. iiifo_jficld in the sqleproc function has the database 

In another embodiment, the invention is directed to a varying character datatype, and is typically unused, 

computer program product conqaising a computer readable ^5 'j^e input_^args in the sqleproc fiinction are input, scalar 

medium having control logic (computa software) stored arguments that are passed to the procedure that is being 

therein. The control logic, when executed by the processor caUed (i.e., the procedure identified by the procedure_to_ 

204, causes the processor 204 to perform the functions of the invoke parameter). The input_args are discussed further 

invention as described herein. below. 

In another embodiment the invention is inq)lemented ^ The output_args in the sqleproc function are ou^ut, 

p rimar ily in hardware using, for example, one or more scalar arguments that are returned from the procedure that is 

hardware state machines. Implementation of such hardware being called (i.e., the procedure identified by the 

state machines so as to perform the functions described procedure„to_invoke parameter). The output_args arc dis- 

herein will be apparent to persons skilled in the relevant cussed further below. 

art(s). The communication_area in the sqleproc function is an 

sqlca ("sqlca" stands for SQL communication area) structure 

SQLEPROC Function that contains status codes that are returned by the sqleproc 

r^AT^^^A ^ iL ^- I.J, i_ function. These status codes spediy the status of the call to 

TTie CAE 114 supports a funcbonc^ ^^^^^^ .^^^^^^ ^ procedure_to_invoke 

sql stands for the weU known sfructured ^ J^^^^^ ^^^^^^ p/octHuzc successfuUy 

and ^n>c stands for procedure. As wiU be appreciated by ^^^^^^^ ^^^^^ ^^^^ ^^^ ^ 

persons skiUed m tiie relevant ai^s), the structiired qu«y ^^^^^ information is returned by the sqleproc 

Unguage is the wdl known database language of the DB2 ^^^^^^ (retum_code). 
RDBMS. 

The sqlq)roc function is documented in a number of 63 The sqlda Data Structure 

publicly available documents, such as DATABASE 2 OS/2 The CAE 114 supports an sqlda data structure ("sql" 

Programming Reference, Order Number S62G-3666-00, stands for structured query language, and "da" stands for 
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descriptor area). The input_args parameter and the output^ includes an sqlvarl parameter having a pointer 606 that 

args parameter in the sqleproc function are variables of type points to a first scalar value in a memory 6(4 (corresponding 

sqlda. to the main memory 208 and/or the secondary memory 210 

The sqlda data structure is documented in a number of ^^^^ 1^^)' ^ ^^^^ parameter having a pointer 608 

pubUdy available documents, such as DATABASE 2 OS/2 5 Pomts to a second scalar value, and an sqlvar3 param- 

Prograinsilng Reftxence, Order Number 8620-366^00. ^JZ^t"^^ ^^^^ P^^^.^ a third s^ value. 

March 1993, DATABASE 2 ADC/000 Programming ^'^^ Procedures 

Operating Systern^ Extentol Edition Datobase ^^^ and reg^ring stored procedures and user-defined ftinction^^ 

Programmmg Guide and Refjence,905a905.^ lO shall now bedescribed It is noted that "stored procedure" in 

arc mcorporated herem by reference m theur endrcties. The the context of the present invention is a well known term and 

documented purpose of the sqlda data structure, as stated in refers to a procedure that runs at the location of the database 

all such documents known to the Inventors, is to pass scalar server and that is called by a database client application, 

values between a host language and DB2, including values Likewise, **user-defined function" in the context of the 

that describe the columns of a resultset row for a query ^5 present invention is a well known term and refers to a 

specified for an SQL PREPARE staten:ient (the sqlda con- function that runs at the location of the database server and 

tains a description of the output columns from DB2), or for that is called by the DBMS, and that is specified in an SQL 

an SQL SELECT statement (the sqlda contains a description statement. Stored procediu:es and user-defined functions are 

of the host variables to receive the values of a row, input to collectively called '^procedures" herein. 

DB2), and values passed to or received from procedures that 20 Flowchart 302 in FIG. 3 depicts the operation of the 

are called using the sqleproc function. The sqlda data invention when distributing, making, and registering stored 

structure is not intended, and not capable of , passing vector procedures and user-defined functions. Flowchart 302 

values. begins with step 304, where control immediately passes to 

The term "scalar value" is well known, and refers to a 

value having a single value and/or dimension. Integers and ^ ^ ^ ^® platform 104 creates a 

strings are examples of scalar values. Likewise, the tenn Procedure 112 to perform a desired function in a well known 

'Vector value" is well known, and refers to an array of values m^ner. , . „ 

or structured data values. Arrays and tables are exan^les of ^^^^ distribute the procedure 112 to 

vector values. A file can be read into memory as a vector ^J^f^^ ^^J^^ ^* performs 

vahie (a file containing an array of strings or an array of ^ ^ "^^^^^ ^ (graphical user 

structures, for example), or as a scalar value (a file contain- ^^f^l ^^^'^^ l^^^f P^ ^^^^^^ 

ing a single string, for exanmle). For reference purposes, . displays a preferably scroUable Hst 110 of all 

files read into memory as vector values are called vector debases available in the database system 102. This infor- 

files, and files read into memory as scalar values are called "lation is obtainable from DB2 m a weU known manner. The 

scalar files. TVpicaUy, files associated with procedures and UO includes an alias of each database, 

user-defined functions represent vector files. ^ appreciated by persons skilled in the relevant 

Th^ fi,- ^of« .^.«f,.™ *«ti«„. srt(s), each alias specifies a database and a server 118, 120, 

The syntax of the sqlda data structure is as foUows: ^^^^22 on which £edatabase resides. 

- In step 310, the user selects one or more database aliases 

type Gqida ^ 1^^* Stored procedure will be distributed to 

sqidaid /* An tdentifier */ tbc servers 118, 120, and/or 122 on which the databases 

sqidabc /• SQLDA size in bytes •/ assodated with the selected database aliases respectively 

y^of^^::^Liv "'^'^ bdaw). Far reference pmpose.. these 

sqlvarl servers 118, 120, and/or 122 are called target (or destination) 

sqlvsr2 45 Servers. 

* The user in step 310 also specifies a target path for each 

, target server. The target path specifies the area in storage of 

sqivarN target scTvcr where tiie linked procedure will be stored 

end (after the make process has been p^ormed). Flowchart 402 
— 50 in FIG. 4 depicts the manner in which the invention deter- 

— . . . ^ *u . . t., * minesthistigetpathforeach selected database. If the user 

The sqidabc parameter specifies the size of a variable of ^ ^ 310 expUdtiy entered a target path, tiien this target 

type sqlda. For example for an s^ch >jat^ 10 sqlvars, the ^ 406 and 408). If the user in step 310 did 

sqidabc will preferably be 16K44nO) bytes. not enter an explicit target path, tfien the GUI 108 in step 410 

The sqlda data structure aUows a variable number of 55 determines wheUicr a target path for die target server was 

sqlvar parameters. The total number of sqlvar parameters fOT previously specified in an initialization file stored at the 

any given parameter of type sqlda is specified in the sqhi cUent platform 104 (the initialization file may have previ- 

field. The actual number of sqlvar parameters used is speci- ously been created by a system administrator, for exan^le). 

fied in the sqld field. If such a target path exists in the initialization file, then this 

Scalar values tiiat are to be passed to die procedure 60 target path is used (step 412). Odierwise, the GUI 108 uses 

identified by the procedure_to_invoke parameter are asso- a default path as the target path (step 414). The GUI 108 

dated with the sqlvar parameters on an one-to-one basis. customizes this default path for the particular target server 

Each sqlvar parameter includes a pointer. The scalar values by obtaining the DB2 installation path from DB2 via the 

that are to be passed to the procedure arc stored in areas of CAE 114 in a weD known manner, and adding the path to the 

memory. The pointers in the sqlvar parameters are dien set 65 server (that is preferably in the DB2 installation path), 

so they point to Uiese areas in memory. For exan^le, this is In step 312, die GUI 108 commands the CAE 114 to 

shown in FIG. 6, where the input_arg parameter 602 transfer the file(s) associated with the procedure 112 to 
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Stored procedures on the servers 118, 120, and/or 122 (Le., the file(s) associated with the procedure 112. the names of 

the target servers) on which the selected databases reside. these files, and the target path in the target server for the 

CThere may be one or more files associated with the proce- linked procedure (this target path for the target server being 

dure 112, sudi as the main routine, subroutines, library processed was determined in step 310 of flowchart 302). In 

routines, header files, data files, etc.) The GUI 108 also 5 particular, the GUI 108 sets the pointers in the sq^var 

commands these stored procedures on the servers 118, 120, parameters to point to areas in memory that contain the 

and/or 122 (via the CAE 114) to make and register the contents of the files associated with the procedure 112, an 

procedure 112. area of memory (or multiple areas of memory) that store the 

In response to the commands received in step 312, the names of these files, and an area of memory that stores 

CAE 114 in step 314 transmits the file(s) associated with &e 10 information that identifies the target path for die linked 

procedure 112 to the target servers. Also, tiie CAE 114 in procedure (linking is performed during the make process.), 

step 316 transmits to the target servers commands to make jhis is represented in FIG. 6, for exan^le, where the first 

the procedure 112. scalar value represents the file corresponding to the proce- 

Prcfcrably, the CAE 114 uses the sqlcproc function dure 112 (in this example, the procedure 112 only has one 

(described above) to invoke the make stored procedure 128 15 file), the second scalar value represents a string tfiat is equal 

at eadi target server. The make stored procedure 128 oper- to the name of the file, and the third scalar value represents 

ates to make (or build) the procedure 112. Approaches for a string that is equal to the target path fos the Unfccd 

making or building procedures are well known. Any of these procedure. 

niay be used to implenient the make stored procedure 112. j^^^ noted that the file corresponding to the procedure 112 

Alternatively, the make procediffe 112 is miplemented m 20 preferably a vector value, not a scalar value. The sqlda 

accortoa^ito Ac teachi^ of U.S. U.S. patent aj^a- ^^^^ accommodate vector values. Thus, the 

3^ sqlda data structure cannot be used to pass this file to the 

™S^»^2^^^^^^^ ^^x^ ™™™™ P'^^^^ure identified by the proc«dure_to^voke param- 

POTER PROGRAM TO INVOKE AN D^TERPREITVE ^^r. ConsequenUy, according to the present invention, the 

COMPUTER PROGRAM." incorporated haein by refer- 25 qui 108 oJnver^ die file To a striig (strings are scalar 

ence in its entirety. values; accordingly, strings may be passed using the sqlda 

nie CAF 114 in step 316 also tomsmits to the target data structure). He first scalar value in the example of HG. 

server commands to stored proc«lures that register the « represents this string representation of the file associated 

procedure 112. Preferably, the CAE 114 uses the sqlq)roc the procedure 112. 

function (described above) to invoke the registration stored 30 ^,rr _ v ^ii • » j -^v ^ 

procedure 130 at each target server. Hie reSration stored ^^,,}^ «>"Jf*^ '"S^ 

^edure 130 operates t^ register the pio^e 112 with P^jT^ ^ sfrmg usmg any wefl faiown process, 

Ac DB2 RDBMS at each ^et scrv^ Approaches for '"^ ""'-^ *ara<to or one 

registering procedures with the DB2 RDBMS are weU " j™"' ~«=»t«fmg ^ Ime to a s^g, and 

known. A of these may be used to implement the regis- 35 con^tenatmg specie stogs to ddimrt 1^^ 

tration proidure 130 conUnues until all files have been read mto stnngs. 

Howchart 302 is complete after the perfcnnance of step ^ step 510, the GUI 108 invokes the sqleproc function 

316, as indicated by step 318. ^^^S procedure_to_invoke parameter as set in step 

506, and the input^args parameter as set in step 508. 

Using the CAE to "mnsfer FUes ^ Howchart 502 is complete after step 510 is performed, as 

As explained above, in step 312 of flowchart 302 the GUI indicated by step 512. 

108 commands the CAE 114 to transmit the file(s) assod- In response to the GUI 108*s invocation of the sqleproc 

ated widi the procedure 112 to the target servers. The CAE function in step 510, the CAE 114 in step 314 of flowdiait 

114 5 performs such file transfer in step 314. However, as 302 (FIG, 3) perfcnns the sqleproc function. In doing so, the 

discussed above, the CAE 114 provides no facilities for 45 CAE 114 transmits the file(s) (via the input_args parameter) 

transferring files between platforms. associated with the procedure 112 to the file transfer proce- 

According to the present invention, the sqleproc function dure 126 in the target server being processed. As noted 

provided by the CAE 114 is used to transfer files. Such use above, the steps of flowchart 502 are performed for each 

represents an undocumented use of the sqleproc function, target serva, such that the file(s) associated with the pro- 

since the sqleproc function is intended only to remotely 50 cedure 112 are sent to all of the target servers, 
invoke procedures. This undocumented use of the sqleproc 

function was discovered and developed by the Inventors. Operation of the File Transfer Procedure 

This use of the sqlcproc function is represented by a flow- As noted above, in step 314 of flowdiart 302 (FIG. 3) the 

chart 502 in FIG. 5. The GUI 108 performs the steps of CAE 114 performs the sqlcproc function. In doing so, the 

flowchart 502 in step 312 (FIG. 3) for each target server. 55 CAE 114 sends a command to the DB2 RDBMS in each 

Flowdiart 502 begins with step 504, where control imme- target server to invoke the file transfer procedure 126. As 

diately passes to step 506. pan of such operation, the data stored in the mcm<Hy areas 

In step 506, the GUI 108 sets the procedure_to_invoke (of the client 106) addressed by the pointers in the sqlvars of 

parameter in the sqleproc function equal to a string that the input_args parameter are transferred to the target serv- 

identifies the file transfer stored procedure 126, and the path 60 crs. These pointers are then adjusted to address nMsmory 

to the file transfer stored procedure 126 in the target server areas in the target servers where the transferred data are 

being processed. The DB2 installation path infcffmation is stored. Such operation of the sqleproc function is well 

obtainable from DB2 in a well known manner, to whidi the known. 

GUI adds the path to the server stored procedure for file The operations perfomed by the file transfer procedure 

*^sfer. 65 126 (once invoked) are represented by flowchart 702 in FIG. 

In step 508, the GUI 108 sets the input_args parameter in 7. Flowchart 702 begins with step 704, where control 

the sqleproc function to identify and include the contents of immediately passes to step 706. 
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In step 706, the file transfer procedure 126 receives the 
inpat_args parameter. 

In step 708, the file transfer procedure 126 uses the 
pointers in the sqlvars of the input_args parameter to 
retrieve the file name(s) of the file(s) associated with ttie 
procedure 112. The use of pointers to reference memory 
areas, and to retrieve data from such memory areas, is well 
known. 

In step 710, the fUe transfer procedure 126 uses the 
pointers in the sqlvars of the input„aigs parameter to 
retrieve the string representation(s) of the file(s) associated 
with the procedure 112. 

In step 712, the file transfer procedure 126 uses the 
pointers in the sqlvars of the input_args parameter to 
retrieve the target path. 

In step 714, the file transfer procedure 126 vmtes the 
string rq)resentation(s) (retrieved in step 710) to file(s) 
(preferably one file per string representation). The procedure 
for writing a string to a file is analogous to the procedure for 
converting a file to a string (described above), and will be 
apparent to persons skilled in the relevant art(s). The files are 
written under the file names retrieved in step 708. The file 
format is implementation dependent 

While various embodiments of the present invention have 
been described above, it should be understood that they have 
been presented by way of example only, and not limitation. 
Thus, the breadth and scope of ttie present invention should 
not be limited by any of the above-described exemplary 
embodiments, but should be defined only in accordance widi 
the following claims and their equivalents. 

Having thus described our invention, what we claim as 
new and desire to secure by Letters Patent is: 

1. A method of transferring a file from a client platfcnm to 
a server platfonn, the server platform coupled to the client 
platform, a "062** relational database management system 
(RDBMS) executing on the server platform, die method 
con^sing the steps of: 

(1) at the client platform, converting the file to a string; 

(2) at the client platform, causing a pointer in an input_ ^ 
args parameter to point to said string, said input^args 
parameter being of a **sqlda" data type, said pointer 
being part of a "sqlvar" parameter defined by the sqlda 
data type, the sqlda data type being suitable for passing 
scalar values to procedures; and 

(3) at the client platform, invoking a "sqleproc" function 
provided by a "client application enablement" {CAE) 
module, the CAE module being resident in the client 
platform and representing a client component of the 
DB2 RDBMS, a parameter list of said sqleproc func- 
tion comprising said input_args parameter and a 
procedure_to_invoke parameter that identifies an 
user-specified procedure located on the server platform, 
said sqleproc function when executed causing said 
input__args parameter to be passed to said user- 
specified procedure at the server platform, and also 
causing said user-specified procedure to be invoked at 
the server platform. 

2. A method of transferring a file from a client platform to 
a server platform, the client platform coupled to the serva 
platform, a "DB2** relational database management system 
(RDBMS) executing on the server platfonn, the method 
coursing the steps of: 

(1) at the client platform, converting the file to a string; 

(2) at the client platform, setting a procedure_to_jnvoke 
parameter equal to information identifying a file trans- 
fer procedure located at the server platform; 
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(3) at the client platform, causing a pointer in a first 
''sqlvar** parameter to point to said string, and causing 
a pointer in a second sqlvar parameter to point to a file 
name of the file, the first and second sqlvar parameters 
being part of an input_args parameter, the input_aigs 
parameter having a "sqlda" data type, the sqlda data 
type being suitable for passing scalar values to proce- 
dures; and 

(4) at the client platform, invoking a "sqleproc" fimction 
provided by a "client application enablement" (CAE) 
module, the CAE module being resident in the client 
platform and representing a client component of the 
DB2 RDBMS, a parameter list of said sqleproc func- 
tion comprising said input^^args parameter and said 
procedure_Jo_invoke parameter, said sqleproc func- 
tion when executed causing said input^args parameta 
to be passed to said file transfer procedure at the server 
platform, and also causing said file transfer procedure 
to be invoked at the server platform. 

3. The method of claim 2, further comprising the steps of: 

(5) at the server platform, receiving the input„args 
parameter; 

(6) at the server platform, using said pointer in said first 
sqlvar parameter of the input_args parameter to access 
and retrieve said string; 

(7) at the server platform, using said pointer in said 
second sqlvar parameter of the input_args parameter to 
access and retrieve said file name; and 

(8) at the server platformi, writing said string to a new file 
in the server platform using said file name. 

4. The method of claim 3, further conq)rising the step of: 

(9) at the client platform, causing a pointer in a third 
sqlvar param^er to point to a target path string. 

5. liie method of claim 4, further comprising the step of: 

(10) at the server platform, using said pointer in said third 
sqlvar parameter of the input_args parameter to access 
and retrieve said target path string; 

wherein step (8) comprises the step of: 

at the server platform, writing said string to a new file 

using said file name at a location in said server platform 

identified by said target path string. 

6. A method of transferring a file from a client platform to 
a server platform, the cHent platform coupled to the server 
platform, a "DB2" relational database management system 
(RDBMS) executing on the server platform, the method 
comprising the steps of: 

(1) at the server platform, receiving an input_args param- 
eter being of a "sqlda" data type, said input_args 
parameter comprising a "sqlvar** parameter defined by 
said sqlda data type, said sqlvar parameter conqirising 
a pointer pointing to a string that was transferred from 
the client platform to the server platform, said string 
being a string representation of a file located on the 
client platform; 

(2) at the server platform, using said pointer in said sqlvar 
parameter of the input^aigs parameter to access and 
retrieve said string; 

(3) at the server platform, writing said string to a new file. 

7. The m^od of claim 6, wherein said input.args 
parameter comprises a second sqlvar parameter having a 
pointer that points to a file name of said file, and a third 
sqlvar parameter having a pointer that points to a target path 
string, the method further conq)rising the steps of: 

(4) at the server platform, using said pointer in said 
second sqlvar parameter of the input^args parameter to 
access and retrieve said file name; and 
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(5) at the server platfom. using said pointer in said third 
sqlvar parameter of the input_args parameter to access 
and retrieve said target path string; 
whaein step (3) comprises the step of: 
at the server platfonn, writing said string to a new tile 5 
using said iiie name at a location in said server 
platform identified by said target path string. 

8. A method for enabling an user to dispute a procedure 
from a client platform to a plurality of server platforms, and 
for enabling the user to make and register the procedure at 10 
the server platforms, a relational database manage- 
ment system (RDBMS) executing on each server platform, 
con^sing the steps of: 

(1) at the client platform, displaying a list of servers; 

(2) at the client platform, enabling the user to select any 15 
of said servers; 

(3) at the client platform, commanding a "client applica- 
tion enablement" (CAE) module to distribute a file 
associated with the procedure to the selected servers, 
the CAE module being resident in the client platform 20 
and representing a client component of the DB2 
RDBMS; and 

(4) at the client platfcHm, conmianding the CAE module 
to cause the selected servers to make and register the 
procedure; ^ 
wherein step (3) comprises the steps of: 

(a) converting the file to a string; 

(b) setting a procedure_to_jnvoke parameter equal to 
information identifying a file transfer procedure 
located at each selected server; 

(c) causing a pointer in a first "sqlvar" parameter to 
point to said string, and causing a pointer in a second 
sqlvar parameter to point to a file name of the file, the 
first and second sqlvar parameters being part of an 
input_args parameter, the input_args parameter 
having a **sqida*' data type, the sqlda data type being 
suitable for passing scalar values to j^ocedures; and 

(d) invcrfdng for each selected server a "sqleproc" 
fiinction provided by the CAE module, a parameter 
list of said sqlqiroc function con^sing said input_ ^ 
args parameter and said procedure_to_invoke 
parameter, said sqleproc fiinction when executed 
causing said iiq)ut„args parameter to be passed to 
said file transfer procedure at each selected server, 
and also causing said file transfer procedure to be 
invoked at each selected server. 

9. The metiiod of claim 8, further comprising the steps of: 

(5) at each scrva, receiving the input_args parameter; 

(6) at each server, using said pointer in said first sqlvar ^ 
parameter of the input^args parameter to access and 
retrieve said string; 

(7) at each server, using said pointer in said second sqlvar 
parameter of the ioput_args parameter to access and 
retrieve said file name; and 

(8) at each server, writing said stdng to a new file in said 
eadi server using said file name. 

10. The method of daim 8, wherein step (4) comprises the 
step of: 

setting the procedurc_to.3iVQke parameter equal to eo 
information identifying a make function located at each 
selected server; and 

invoking for each selected server the '"sqleproc" function, 
said sqleproc function when executed causing each 
selected server to invoke the make function, the make 65 
function when executed operating to make the proce- 
dure. 
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11. The method of claim 8, wherein stq) (4) conqsises the 
step of: 

setting the procedure to_Jnvoke parameter equal to 
information identifying a registration function located 
at each selected server; and 

invoking for each selected server the "sqleproc" function, 
said sqleproc function when executed causing each 
selected server to invoke the registration function, the 
registration function when executed operating to reg- 
ister the procedure with the DB2 RDBMS at said each 
selected server. 

12. A system of transferring a file from a client platfonn 
to a server platform, the client platform coupled to the server 
platform, a "DB2" relational database management system 
(RDBMS) executing on the server platform, the system 
comprising: 

means, at the client platform, foe converting &e file to a 
string; 

means, at the client platfonn, for setting a procedure. 
to_invoke parameter equal to information identifying a 
file transfer procedure located at the server platform; 

means, at the client platform, for causing a pointer in a 
first "sqlvar" parameter to point to said string, and 
causing a pointer in a second sqlvar parameter to point 
to a file name of the file, the first and second sqlvar 
parameters being part of an input.args parameter, the 
input_args parameter having a "sqlda" data type, the 
sqlda data type being suitable for passing scalar values 
to procedures; and 

means, at the client platform, for invoking a "sqleproc" 
function provided by a "client application enablement" 
(CAE) module, the CAE module being resident in the 
client platfonn and representing a client con^nent of 
the DB2 RDBMS, a parameter list of said sqleproc 
function comprising said input_args parameter and 
said procedure__to_jnvoke parameter, said sqleproc 
function when executed causing said input_args 
parameter to be passed to said file transfer procedure at 
the server platfonn, and also causing said file transfer 
procedure to be invoked at the server platf ocnL 

13. The system of claim 12, further comprising: 
means, at the server platform, for receiving the input_ 

args parameter; 

means, at the server platform, for using said pointer in 
said first sqlvar parameter of the input_args parameter 
to access and retrieve said string; 

means, at the server platform, for using said pointer in 
said second sqlvar parameter of the input_args param- 
eter to access and retrieve said file name; and 

writing means, at the server platform, for writing said 
string to a new file in the server platform using said file 
name. 

14. The system of claim 13, further comprising: 
means, at the client platform, for causing a pointa in a 

third sqlvar parameter to point to a target path string. 

15. The system of claim 14, further comprising: 
means, at the server platform, for using said pointer in 

said third sqlvar parameta of the input_args parameter 
to access and retrieve said target path string; 
wherein said writing means includes means for writing 
said string to a new file using said file name at a 
location in said server platform identified by said target 
path string. 

16. A server platfom coupled to a client platfonxL a 
"DB2" relational database management system (RDBMS) 
executing on the server platform, the server platform com- 
prising: 
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means for receiving an input_args parameter being of a 
"sqlda" data type, said input^aigs parameter compris- 
ing a "sqlvar" parameter defined by said sqlda data 
type, said sqlvar parameter comprising a pointer point- 
ing to a string that was transfetred from the client 5 
platform to the server platform, said string being a 
string representation of a file located on the dient 
platform; 

means for using said pointer in said sqlvar parameter of 
the input_args parameter to access and retrieve said 
string; and 

writing means for writing said string to a new file in the 
server platform. 

17. The server platform of daim 16, wherein said inputs 
args parameter cojiq}rises a second sqlvar parameter having 
a pointer that points to a file name of said file, and a third 
sqlvar parameter having a pointer that points to a target path 
string, the server platform further comprising: 

means for using said pointer in said second sqlvar param- 
ctcr of the input^args parameter to access and retrieve 
said file name; and 

means for using said pointer in said third sqlvar parameter 
of the input_args parameter to access and retrieve said 
target path string; 25 

wherein said writing means comprises means for writing 
said new file using said file name at a location in said 
server platform identified by said target path string. 

18. A database system for enabling an user to distribute a 
procedure from a client platform to a plurality of server 30 
platforms, and for enabling the user to make and register the 
procedure at the server platforms, a "DB2** relational data- 
base management system (RDBMS) executing on each 
server platform, the database system comprising: 

means, at the client platform, for displaying a list of 
servers; 

means, at &e client platform, for enabling the user to 
select any of said servers; 

CAE commanding means, at the client platform, for ^ 
commanding a "client application enablement" (CAE) 
module to distribute a file associated with the procedure 
to the selected servers, the CAE module being resident 
in the client platform and representing a client compo- 
nent of the DB2 RDBMS; and 

45 

make and register means, at the client platform, for 
commanding the CAE module to cause the selected 
servers to make and register the procedure; 
wherdn said CAE commanding means comprises: 
means for converting the file to a string; 50 
means for setting a procedure_to_invoke parameter 
equal to information identifying a file transfer pro- 
cedure located at each sdected server; 
means for causing a pointer in a first "sqlvar" parameter 
to point to said string, and causing a pointer in a S5 
second sqlvar parameter to point to a file name of the 
file, die first and second sqlvar parameters being part 
of an input_args parameter, the input_args param- 
eter having a "sqlda" data type, the sqlda data type 
being suitable for passing scalar values to proce- 60 
dures; and 

means for invoking for each selected server a 
"sqleproc" function provided by the CAE module, a 
parameter list of said sqleproc function comprising 
said input_args parameter and said procedure__to_ 65 
invoke parameter, said sqleproc function when 
executed causing said input_^args parameter to be 
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passed to said file transfer procedure at each sdected 
server, and also causing said file transfer procedure 
to be invoked at eadi selected server. 

19. The database system of claim 18, further comprising: 
means, at each server, for recdving the input„args 

parameter; 

means, at each server, for using said pointer in said first 
sqlvar parameter of the input_args parameter to access 
and retrieve said string; 
means, at each server, for using said pointer in said second 
sqlvar parameter of the input^args parameter to access 
and retrieve said file name; and 
means, at each server, for writing said string to a new file 
in the server using said file name. 

20. The system of claim 18, wherein said make and 
register means comf^es: 

means for setting the procedure_to_Jnvoke parameter 
equal to information identifying a make function 
located at eadi sdected server; and 
means for invoking for each selected server the 
"sqleproc" function, said sqleproc function when 
executed causing each sdected server to invoke the 
make function, the make function when executed oper- 
ating to make the procedure. 

21. The system of claim 18, wherein said make and 
register means comprises: 

means for setting the procedure_to_Jnvoke parameter 
equal to information identifying a registration function 
located at each sdected server; and 
means for invoking for each selected server the 
"sqleproc" function, said sqleproc function when 
executed causing each sdected server to invoke the 
registration function, the registration function when 
executed operating to regista the procedure with the 
DB2 RDBMS at said each sdected server. 

22. A program storage device readable by a machine, 
tangibly embodying a program of instructions executable by 
the machine to perform method steps for transferring a fiie 
from a client platform to a server platform, the server 
platform coupled to the client platfonn, a "DB2" relational 
database muanagement system (RDBMS) executing on the 
server platform, said method steps comprising: 

(1) at the client platform, converting the file to a string; 

(2) at tiie client platform, causing a pointer in an input_ 
args parameter to point to said string, said input.args 
parameter being of a "sqlda" data type, said pointer 
being part of a "sqlvar^ parameter defined by the sqlda 
data type, the sqlda data type being suitable for passing 
scalar values to procedures; and 

(3) at the client platform, invoking a "sqleproc" function 
provided by a "client application enablement" (CAE) 
module, the CAE module being resident in the client 
platform and representing a client conq)onent of die 
DB2 RDBMS, a parameter list of said sqlq)roc func- 
tion comprising said input^args parameter and a 
procedure_to_invofce parameter that identifies an 
user-specified procedure located on the server platform, 
said sqleproc function when executed causing said 
input_args parameter to be passed to said user- 
specified procedure at the server platform, and also 
causing said user-specified procedure to be invoked at 
the server platform. 

23. A program storage device readable by a machine, 
tangibly embodying a program of instructions executable by 
the machine to perform method steps for transferring a file 
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from a client platform to a server platform, the dicDt 
platform coupled to the server platform, a "DB2" relational 
database management system (RDBMS) executing on the 
server platform^ said method steps comprising: 

(1) at the client platfomt converting the file to a string; 

(2) at the client platform, setting a procedure_to_invoke 
parameter equal to information identifying a file trans- 
fer procedure located at the server platform; 

(3) at the client platform, causing a pointer in a first 
'*sqlvar" parameter to point to said string, and causing 
a pointer in a second sqlvar parameter to point to a file 
name of the file, the first and second sqlvar parameters 
being part of an input_args parameter, the input_args 
parameter having a "sqlda" data type, the sqlda data 
type being suitable for passing scalar values to proce- 
dures; and 

(4) at the client platform, invoking a "sqieproc" function 
provided by a "client application enablement" (CAE) 
module, the CAE module being resident in the client 
platform and representing a client con^onent of the 
DB2 RDBMS, a parameter list of said sqleproc func- 
tion comprising said input__args parameter and said 
procedure_to_Jnvoke parameter, said sqleproc func- 
tion when executed causing said input_args parameter 
to be passed to said file transfer procedure at the server 
platform, and also causing, said file transfer procedure 
to be invoked at the server platform. 

24. The program storage device of claim 23, said method 
steps fiirther concqnising the steps of: 

(5) at the server platform, receiving the input_.args 
parameter, 

(6) at the server platform, using said pointer in said first 
sqlvar parameter of the input_args parameter to access 
and retrieve said string; 

(7) at the server platform, using said pointer in said 
second sqlvar parameter of the input_args parameter to 
access and retrieve said file name; and 

(8) at tiie server platform, writing said string to a new file 
in the server platform using said file name. 

25. The program storage device of claim 24, said method 
steps further comprising the step of: 

(9) at the client platform, causing a pointer in a third 
sqlvar parameter to point to a target path string. 

26. The program storage device of claim 25, said method 
steps further comprising the step of: 

(10) at the servo: platform, using said pointer in said third 
sqlvar parameter of the uiput_args parameter to access 
and retrieve said target path string; 
wherein step (8) comprises the step of: 
at the server platform, writing said string to a new file 

using said file name at a location in said server 
platform identified by said target path string. 

27. A program storage device readable by a machine, 
tangibly embodying a program of instructions executable by 
the madiine to perform method steps for transferring a file 
firom a client platform to a server platfono, the client 
platform coupled to the server platfonn. a **DB2** relational 
database management system (RDBMS) executing on the 
server platform, said method steps comprising: 

(1) at the server platform, receiving an input__args param- 
eter being of a "sqlda" data type, said input_args 
parameter comprising a "sqlvar" parameter defined by 
said sqlda data type, said sqlvar parameter comprising 
a pointer pointing to a string that was transferred from 
the client platform to the server platfcHm. said string 
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being a string representation of a file located on the 
client platform; 

(2) at the serva platform, using said pointer in said sqlvar 
parameter of the input^args parameter to access and 
retrieve said string; 

(3) at the server platform, writing said string to a new file. 

28. The program storage device of daim 27, wherein said 
input_args parameter con^)rises a second sqlvar parameter 
having a pointer that points to a file name of said file, and 
a third sqlvar parameter having a pointer that points to a 
target padi string, said method steps further comprising die 
steps of: 

(4) at the server platform, using said pointer in said 
second sqlvar parameter of the input_args parameter to 
access and retrieve said file name; and 

(5) at the server platform, using said pointer in said tiiird 
sqlvar parameter of ihc input_args parameter to access 
and retrieve said target path string; 

wherein step (3) comprises the step of: 
at the server platform, writing said string to a new file 
using said file name at a location in said server 
platform identified by said target path string. 

29. A program storage device readable by a machine, 
tangibly embodying a program of instructions executable by 
the machine to perform method steps for enabling an user to 
distribute a procedure from a client platform to a plurality of 
server platforms, and for enabling the user to make and 
register the procedure at the server platfonns, a "DB2" 
relational database management system (RDBMS) execut- 
ing on each server platform, said method steps comprising: 

(1) at the client platform, displaying a list of servers; 

(2) at the dient platform, enabling the user to select any 
of said servers; 

(3) at the client platform, commanding a "client applica- 
tion enablemenf * (CAE) module to distribute a file 
assodated with the procedure to the selected servers, 
the CAE module being resident in the client platform 
and representing a client component of the DB2 
RDBMS; and 

(4) at the client platform, commanding the CAE module 
to cause the sdected servers to make and register the 
procedure; 

wherein step (3) comprises the steps of: 

(a) converting the file to a string; 

(b) setting a procedure_to__invoke parameter equal to 
inf<Hination identifying a file transfer procedure 
located at each selected server, 

(c) causing a pointer in a first "sqlvar" parameter to 
point to said string, and causing a pointer in a second 
sqlvar parameter to point to a file name of the file, the 
first and second sqlvar parameters being part of an 
input_args parameter, the Lnput_args parameter 
having a "sqlda" data type, the sqlda data type being 
suitable for passing scalar values to procedures; and 

(d) invoking for each selected server a "sqleproc" 
function provided by the CAE module, a parameter 
list of said sqleproc function comprising said input_ 
args parameter and said procedure__to_jnvoke 
parameter, said sqleproc function when executed 
causing said input^args parameter to be passed to 
said file transfer procedure at each selected server, 
and also causing said file transfer procedure to be 
invoked at each sdected server. 

30. The program storage device of claim 29, said method 
steps further comprising the steps of: 
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(5) at each server, receiving the input^_args parameter; invoking for each selected server the "sqleproc" function, 

(6) at each server, using said pointer in said first sqlvar said sqleproc function when executed causing each 
parameter of the input_args parameter to access and selected server to invoke the registration function, the 
retrieve said string; registration function when executed operating to reg- 

(7) at each server, using said pointer in said second sqlvar ^ istcr the procedure with the DB2 RDBMS at said each 
parameter of the input_args parameter to access and selected server. 

retrieve said file name; and 33 ^^^^^ ^ ^^^^^ ^ ^^^^^ 

(8) at each server, writing said string to a new file in said 
each server using said file name. 

31. The iffogram storage device of daim 29, wherein step "^^^^^ ^^^^ a vector 
(4) comprises the step of: 

setting the procedure_to_Jnvoke parameter equal to 35. The method of claim 6, wherein said file is a vector 

information identifying a make function located at each file. 

selected server; and 15 ^6. The system of claim 12, wherein said file is a vector 

invoking for each selected server the "sqleproc" function, file, 

s^d sqleproc fiinction whea executed caudng each 37.Theprogramstoragedeviceof claim 22. wherein said 

selected server to invoke the make function, the make fii fii 

function when executed operating to make the proce- ^ ^ ^ vector lue. 

dure. 20 38.Theprogramstoragedeviceof daim 23, wherein said 

32. The program storage device of daim 29, wherdn step file is a vector file. 

(4) con^rises the step of: 39. The program storage device of daim 27, wherein said 

setting the procedure_to_invofce parameter equal to file is a vector file, 
information identifying a registration function located 

at each selected server; and 4c * * * « 
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